************
INTRODUCTION
************

This file describes how to set up and use the Java wrapper code with Melissa DATA's Phone Object.


*************
PREREQUISITES
*************

To make use of the Phone Object Java wrapper you will need:

* An installation of a Java Developer's Kit 1.4.2 or later or an equivalent product.

* The Melissa DATA Phone Object library and data files installed.

	Library = mdPhone.dll
	Data Files = mdAddr.dat, ZIPNPA.txt, mdGlobalPhone.dat, mdPhone.dat

  These files are installed automatically if you run setup.exe from the root of the DQ Suite DVD. 
  You will need to know the location of these files.


**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.


*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.


*****
Setup
*****

Open CreateJarFile.bat in wordpad. Put the path to your Java bin directory to the Java_Dir variable. 

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin

Open RunSample.bat in wordpad. Put the path to your Java bin directory to the the Java_Dir variable.

	Example: set JAVA_DIR=c:\Program Files\Java\jdk1.6.0_01\bin

Open PhoneSample.java and set the License string and path to the data files. To obtain a license string, please 
contact a Melissa Data sales representative at 1-800-800-6245 x3.

  	public static String the_license = "demo";
  	public static String datafile_dir = "C:\\Program Files\\Melissa Data\\DQT\\Data";


*******************
Running the Scripts
*******************

Double Click on CreateJarFile.bat. This should create a file called mdPhone.jar. This file must be 
created successfully to use the Java wrapper.

Copy mdPhone.dll into the directory with RunSample.bat and Double Click on Run RunSample.bat. 
This will compile PhoneSample.java and run the sample program. 


***********
Sample Code
***********

PhoneSample.java contains sample code for using Phone Object. If you make changes to PhoneSample.java,
you must execute RunSample.bat again to recompile the code.

*******
Updates
*******

The wrapper normally does not need to be rebuilt for DQ Suite updates. They are the connection between 
Phone Object (mdPhone.dll) and the Java client code. As long as the method naming changes or deletions in Phone Object, the wrapper does not need to be changed. For newly added methods, the wrapper also does not need to be rebuilt unless you want to use the new methods. 


****
Note
****

The source code and a bat script to compile mdPhoneJavaWrapper.dll is supplied in the 'Interfaces' directory found two folders up.
Since mdPhoneJavaWrapper.dll is already supplied, you do not need to use this unless you have to 
recompile mdPhoneJavaWrapper.dll. Instructions to compile are in BuildWrapper.bat and the README.txt in the Source folder. Please read them before executing the bat file. 



COPYRIGHT NOTICE

(C) 2014 Melissa Data Corporation. All rights reserved.
